home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 1.iso / util / vtt1_3a.zip / README.TXT next >
Text File  |  1994-09-10  |  11KB  |  278 lines
  1.  
  2. Release notice:  Windows 3.1 Terminal Application
  3.                  VT100, XModem, YModem file transfers.
  4.                  Includes sample implementation source code.
  5.  
  6.  
  7.                         MACTerm v1.3 ALPHA TEST Application
  8.                         -----------------------------------
  9.             
  10.             All code etc is sole property of Mike McCammant/MACSoft.
  11.                                              (mikemc@netcom.com)
  12.  
  13. WARNING: This is a VERY simple terminal, please do not NUKE me for it lack
  14.          of terminal functions !!  That is beyond the scope of this release.
  15.          (i.e.  Autodialing etc etc)  You can Hang-up from the Util menu. 
  16.          Some of these functions are planned on later test releases.
  17.          
  18.  
  19.  
  20. Disclaimer:  This alpha test software is released as is, with no warranty 
  21.              as to it's fitness for anything other than a test.  The author 
  22.              assumes zero liability for anything nasty that occurs during 
  23.              or because of it's use..  Also any and all other standard 
  24.              disclaimer stuff that I don't feel like typing is implied..           
  25.  
  26.           
  27.         
  28. Platforms:
  29. ----------
  30.  
  31. Windows 3.1, on a 386 or above, 4M ram.  Has not been tested under NT or 
  32. WFW 3.11.
  33.                     
  34.  
  35. Purpose:
  36. --------
  37.  
  38. The enclosed program has been released in order for the authors,(me, myself 
  39. and I) to aquire feedback concerning the functionality of the VT100 emulation
  40. on a varity of platforms.   Also for testing of the other objects that have
  41. been developed for serial communications, to include X/YModem file transfers.
  42. (ZModem soon I hope !)
  43.  
  44. I have also included TTView.cpp and .h file that uses these objects.  This file
  45. provides the entire functionality of this application external to the objects.
  46. This file is the standard CView class for an MFC 2.5 based VC++ 1.5 application.
  47.  
  48. This application is based on a set of VC++ objects that MAY be released at a 
  49. later time on terms yet to be defined.
  50.  
  51.  
  52.  
  53. MacTerm Object:
  54. ---------------  
  55.  
  56. The VT100 emulation is provided by a VC++ Object that when created, creates
  57. it's own visible window and manages all GUI aspects on it's own. This object
  58. can be minimized and maximized without loss of functionality.  This object 
  59. can exist in multiple instances, but not in this test app.  This object 
  60. accepts its input from a public function call.
  61.  
  62. Underline and Blinking text attributes are supported.
  63.  
  64. 80/132 column switching is somewhat supported, but is not real pretty at this
  65. point.
  66.  
  67. Users can change the default background/text colors in the UTIL/SETUP menu.
  68. These selections are saved in the *.INI file for the application. 
  69.  
  70. There are many variable aspects of this object (i.e. columns, rows etc) that
  71. are, for the purposes of this alpha test, pre-defined and constant. Future
  72. releases, if/when they occur, should include more flexability in this area.
  73.  
  74.  
  75.  
  76. MACComm Object:
  77. ---------------
  78.  
  79. Also implemented is a Communications object that responds to WM_COMMNOTIFY
  80. OR WM_TIMER messages and manages a 16k receive queue.  All the known bugs are 
  81. worked around in this implementation and it functions very well at 19.2 on my 
  82. 486/33.  There have been some reports of this app not functioning properly
  83. under WFW 3.11 using the COMMNOTIFY method in conjunction with the standard
  84. COMM.DRV.  I am not sure why at this point.  The solution if you have problems
  85. is to use the Timer option, or try a different COMM driver.  One called
  86. CyberCom is available via FTP from several sites and is very stable.  
  87.  
  88. By default, XOn/XOff flow control is enabled and it is recommended that it 
  89. remain enabled, at least at high data rates and throughputs.  If you wish to 
  90. disable the flow control, you can do so from the Port Setup Dialog when the 
  91. app is launched.  Fair warning, if you overrun the 16k buffer, the comm port
  92. will lock up. The system should remain stable although the serial port will
  93. stop responding to the app.  There is a port reset selection in the UTIL menu 
  94. that should clear this error condition.
  95.  
  96. Carrier Detect is recovered from the MSR (Modem Status Register) and is 
  97. available from within this object.
  98.  
  99. This object supports both character and block transmission functions, as well
  100. as multiple reception methods, char, block, timed char, timed block, block
  101. with interchar timeout etc...  String/Line reception is not yet supported.
  102.  
  103.                                                                           
  104.                                                                           
  105. XYTransfer Object
  106. -----------------
  107.  
  108. This object currently supports XModem checksum, XModem-CRC, 1K XModem, YModem
  109. and YModem-g batch uploading and downloading.  ZModem is not currently 
  110. implemented but is planned.  On my 486-33, set for 19.2 with a 14.4 modem, 
  111. I get about 2600 cps on text files and 1500-1700 cps on .ZIP files.  This
  112. is downloading using Ymodem-g.  
  113.  
  114. Transfer status is displayed in a modeless dialog box.  
  115.  
  116. On YModem downloads, the object will attempt to rename a duplicate file by
  117. changing the last character of the extension ro filename if no ext, to a 0-9.
  118.  
  119.  
  120. This object performs very well minimized, and the only troubles I have noted are
  121. with YModem-g downloads overflowing the 16k buffer during applications that are
  122. very processor intensive.  Loading Borland's Paradox for Windows(tm) will kill it
  123. every time !  It takes 6-8 seconds to fill up the buffer at 14.4.
  124.  
  125. Default UL/DL directories are set up in the UTIL/SETUP menu selection.  These are
  126. stored in the *.INI file for this application in the windows directory. 
  127.  
  128. NOTE: YModem-g UL not tested !! If you can check it out, let me know if it works.
  129.  
  130.  
  131.  
  132.  
  133. General FYI
  134. -----------
  135.  
  136. One thing that may seem strange to you, when you are receiving a large amount
  137. of data, the virtual screen object will start to scroll multiple rows.  The 
  138. number of scroll rows is based on a % of the total number of screen rows and
  139. a % of the number of characters in the receive buffer.  It will speed up and 
  140. slow down as the buffer fill fluctuates.  This can be a problem when using
  141. a program that manages the cursor (IRC is a good example).  If this feature
  142. causes a problem, it can be toggled on/off in the Util/Setup menu.  As a 
  143. protective measure, this feature is automatically disabled anytime a scroll 
  144. region is defined with a bottom row less than 22.  This seems to work pretty 
  145. well.
  146.  
  147.  
  148.  
  149. Please play with this and provide any constructive feedback you may have to
  150. me.  I can be reached at mikemc@netcom.com.  Please review the Bug List below.
  151.  
  152. With all feedback, please indicate:
  153.  
  154.     a. System description (processor/Speed/RAM/Operating System version)
  155.         
  156.     b. Version of app.
  157.     
  158.     c. Configuration of app(i.e. baudrate, flow etc)
  159.     
  160.     d. your feedback/bugs.  Please be exact in when/how the bug occured.  If 
  161.        you can send an ASCII capture of the data that caused the bug, I have
  162.        an emulator I can run it through..
  163.     
  164.     e. anything else you think is important.
  165.  
  166.  
  167.  
  168. Bug list/Planned fixes:   (as of 9/9/94)
  169. -------------------------
  170.  
  171.     On color setup, not all colors map, only 16 do.  Right now, its trial
  172.     and error.
  173.     
  174.     Need to map ESC key.
  175.     
  176.     Smooth scrolling not yet implemented.                  
  177.     
  178.     ZModem Uploading/Downloading not supported at this time.
  179.     
  180.     Autodial not implemented at this time.
  181.                                             
  182.     Not all 'standard' baud rates are supported.
  183.     
  184.     COM3, port 3E8, IRQ 5 does not work, probably others as well!
  185.     
  186.     Need to set up defaults for com, baud etc in .INI
  187.     
  188. Bug Fix Log: (History)
  189. ------------
  190.  
  191. 8/10/94    Scroll down/reverse linefeed implemented.
  192.  
  193. 8/10/94    ESC1J, erase from beginning of screen to cursor fixed to erase 
  194.            current cursor position also.
  195.              
  196. 8/12/94    All line drawing characters are mapped.
  197.  
  198. 8/12/94    Scroll region functions implemented.
  199.  
  200. 8/12/94    UK character set mapping added. 
  201.  
  202. 8/12/94    Created Underline, Bold and Bold Underline Fonts. (not yet 
  203.            implemented)
  204.                                                                                      
  205. 8/13/94    Delete key now functions as a backspace. (Thanks Sebastien)
  206.  
  207. 8/14/94    Bold and underline implemented (bold is not quite right, width)
  208.  
  209. 8/15/94    Blink Implemented !!
  210.  
  211. 8/16/94    Fix Reverse video screen. (entire scrn, incl existing chars should
  212.            rev)
  213.  
  214. 8/17/94    80/132 column mode switching implemented.
  215.  
  216. 8/19/94    Added color setup for text and background.
  217.  
  218. 8/19/94    Added 80/132 column mode flag and only switch if not already in 
  219.            mode. Why switch if already there?
  220.  
  221. 8/19/94    Added file capture.
  222.  
  223. 8/19/94    Added file capture status to status bar.
  224.  
  225. 8/20/94    WM_TIMER managed communications implemented in Comm Object.  Set at
  226.            50ms.  Comm Object now supports WM_COMMNOTIFY or WM_TIMER driven
  227.            communications. 
  228.  
  229. 8/20/94    Migrated keymapping from view to Comm Object.
  230.  
  231. 8/21/94    Added esc #3,4,5,6,8 to decoding.
  232.  
  233. 8/21/94    Blink was reverse video'ing, corrected for true hide instead of 
  234.            inverting.
  235.  
  236. 8/21/94    Added UpdateStatusBar member functions to Comm Object. Changed 
  237.            capture status to use this function.            
  238.  
  239. 8/21/94    Added statusbar messages to hang-up routine.
  240.  
  241. 8/21/94    Sped up blink from 1100ms to 350ms. 
  242.  
  243. 8/26/94    Added timed WaitForChar functions in comm object.
  244.            Migrated WM_COMMNOTIFY handling over into Comm Object.
  245.            Added functions to turn on/off XON/XOFF on the fly.
  246.            Added Carrier Detect tracking.
  247.            Modified classes to be "file transfer aware".
  248.            Added more selection for Notification and auto-process to
  249.            setup dlg.
  250.  
  251. 8/27/94    Fixed: Loss of caret/cursor after minimizing/maximizing application.
  252.            (sometimes no cursor at all?)
  253.  
  254. 8/30/94    Added XYModem Class.  Inital implementation provides X and Y
  255.            Modem downloads.  
  256.  
  257. 9/2/94     Created file selection dialogs for xfers.
  258.  
  259. 9/2/94     Fixed bug: File Name not properly mapping after completion of xfer.
  260.  
  261. 9/4/94     Fixed bug: YModem DL session completes OK on client, bit host never
  262.            gets final ACK.  (you must ctrl-c on the host)
  263.  
  264. 9/7/94     Added DL status modeless dialog
  265.  
  266. 9/7/94     Added: Color/Directories saved in private profile (.ini file)
  267.  
  268. 9/8/94     Found bug: Serial port will not respond after rec buffer overrun.   
  269.  
  270. 9/9/94     Added port reset in UTIL menu.
  271.  
  272.  
  273. [The End]                                                                                     
  274. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  275.                                             
  276.  
  277.         
  278.